Skip to content

Improve evaluate command docs with better examples and dataset guidance#81

Merged
alexkroman merged 1 commit into
mainfrom
claude/kind-mayer-v4s2wq
Jun 11, 2026
Merged

Improve evaluate command docs with better examples and dataset guidance#81
alexkroman merged 1 commit into
mainfrom
claude/kind-mayer-v4s2wq

Conversation

@alexkroman

Copy link
Copy Markdown
Collaborator

Enhance the evaluate command's help text and examples to provide clearer guidance on usage and available datasets.

Changes:

  • Updated the command docstring to better explain the evaluation process: how audio is transcribed, scored against reference text with normalization, and how the summary pools errors across the dataset
  • Expanded dataset guidance with specific Hugging Face Hub examples:
    • openslr/librispeech_asr (English; clean/other subsets)
    • MLCommons/peoples_speech (real-world US English)
    • distil-whisper/meanwhile (long-form English)
    • PolyAI/minds14 (14 locales; banking calls)
    • diarizers-community/simsamu (French dispatch calls with speaker turns)
  • Replaced the example dataset (mozilla-foundation/common_voice_17_0) with openslr/librispeech_asr for better clarity
  • Added two new usage examples:
    • Non-English audio evaluation with PolyAI/minds14 and --language-code
    • DER scoring on a diarization dataset with diarizers-community/simsamu and --speaker-labels
  • Updated snapshot test expectations to match the new help text and examples

The changes make the command more discoverable and help users understand both what the command does and which datasets are suitable for evaluation.

https://claude.ai/code/session_01WpRHsDXCWYTffZ8eMGK6Er

… help

Mozilla pulled the Common Voice corpora off the Hugging Face Hub in
October 2025 (now exclusively on Mozilla Data Collective), so the
`mozilla-foundation/common_voice_17_0` repo is empty and the datasets
server answers every request with HTTP 500 "The dataset is empty",
breaking the subset/split example verbatim.

Swap it for openslr/librispeech_asr --subset clean, verified end-to-end
against the datasets-server rows API (ungated, parquet-backed, multiple
subsets so --subset is genuinely required, auto-picked test split,
auto-detected audio/text columns). Also expand the eval help with how
scoring works (normalization, pooled summary) and a sampling of vetted
datasets — peoples_speech, minds14, simsamu — plus two new examples
covering non-English audio and HF diarization sets.

https://claude.ai/code/session_01WpRHsDXCWYTffZ8eMGK6Er
@alexkroman
alexkroman enabled auto-merge (squash) June 11, 2026 23:25
@alexkroman
alexkroman merged commit 66d3636 into main Jun 11, 2026
8 checks passed
@alexkroman
alexkroman deleted the claude/kind-mayer-v4s2wq branch June 11, 2026 23:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants